Skip to main content

Documentation | 4payments

This resource is intended for developers who want to integrate with 4payments. Here you will find everything you need to start working with our platform — from authentication and webhooks to handling transactions and cards.

What's new​

A new account workflow

Start with the accounts available to your organization. Each account now tells you whether you can create cardholders and which fields are required. Use its ID to keep cardholders, cards, and transaction history connected.

Follow the account guide
Start hereGET /external/api/accountsThen use the returned account IDPOST /external/api/cardholdersGET /external/api/transactions?accountId=...

1. Choose an account

List your accounts and check balance, currency, and cardholder requirements.

View account API →

2. Create a cardholder

When the account allows it, send its ID and the fields listed as required for that account.

Create a cardholder →

3. Issue and reconcile

Choose a card type linked to the account, then filter transactions with accountId.

View transactions →

More in this release​

Card issuance

Pass an existing cardholder ID or identity details, depending on the selected card type.

Issue a card →

Swaps

Preview a currency conversion, review its quote, then execute it between eligible accounts.

Swap balances →

Physical cards

Issue cards, manage delivery addresses, track applications and deliveries, and activate cards.

Explore physical cards →

Cardholder KYC

Submit identity data during creation or start a verification link when the account requires it.

Review KYC flow →

Extra fees

Handle new declined transaction and cross-border fee events in the extraFee webhook.

View webhook →